Internet Info 1994 March/Internet Info CD-ROM (Walnut Creek) (March 1994).iso/networking/terms/kermit/c/pq2ker.men

Text File | 1988-08-16 | 20.2 KB | 785 lines

DEBUG

17
Main Menu
Kermit-Perq
Kermit-Perq Main Commands.

This is the main command level of Kermit-Perq.  A command can be invoked by
typing its (abbreviated) name, or by pressing tabswitch and selecting it
on the PopUp menu.  If a command requires further keywords or parameters,
you will be prompted for them.  When prompted for a keyword, you may always
press tabswitch to get a PopUp menu, and also always press HELP to get an
explanation.  A prompt for a keyword may be cancelled by entering a blank
line, and you will be returned to the previous command level.  Repeated
RETURN's will eventually return you to the main command level.

To speed up typing, you may always enter the rest of the command line
on one line, e.g. SET PARITY EVEN may be issued as :

Kermit-Perq>SET
SET>PARITY
SET PARITY>EVEN
Kermit-Perq>

or simply as:

Kermit-Perq>SET PARITY EVEN
Kermit-Perq>

Note that the commands, except for SHOW, STATUS and progress reporting
from lengthy commands, are 'silent', i.e. successful execution is not
accompanied by any output.

Ctrl-C will return you to the main command level of Kermit-Perq, after
doing any necessary cleanup, such as aborting a file transfer in progress.
Ctrl-Shift-C will return to the main command level immediately.
>
SEND
-1
SEND Filename
Send specified file(s) to remote Kermit.  File may be text or binary,
but binary file transfer will only be successful if 8-bit quoting is
supported or PARITY NONE is specified.

Format: SEND <local filename> [<remote filename>]

<filename> may contain wildcards.  When <remote filename> is
specified, this is the name for the file under which it will be
stored on the other machine.  If any filename contains wildcards,
the other must contain the same wildcards, in the same order.  The
effect will be as with the Shell COPY command.
>
RECEIVE
-1
RECEIVE Filename
Receive file(s) from remote Kermit. Use when the remote Kermit not has the
SERVER facility.  A SEND command will have to be issued at the remote Kermit.
File may be text or binary, but binary file transfer will only be
successful if 8-bit quoting is supported or PARITY NONE is specified.

Format: RECEIVE [ [<remote filename>] <local filename> ]

When no filename is specified, just take what the other Kermit may send,
and store files under the same names they are sent.

With only local filename specified, the file received will be stored
under this name.  Optionally a '*' may be contained in the filename,
and will be replaced by the received filename.

When both filenames are specified, the filenames received will be
matched with the <remote filename> and stored as <local filename>.
This is primarily intended to be used with wildcards.  If any
filename contains wildcards, the other must contain the same
wildcards, in the same order.  The effect will be as with the Shell
COPY command.

When filenames are specified, but no wildcards, only one file may be
sent from the remote Kermit.
>
GET
-1
GET Filename
Receive specified file(s) from remote Kermit SERVER.
File may be text or binary, but binary file transfer will only be
successful if 8-bit quoting is supported or PARITY NONE is specified.

Format: GET <remote filename> [ <local filename> ]

<filename> may contain wildcards.  When <local filename> is specified,
this is the name for the file under which it will be stored on the Perq.
If any filename contains wildcards, the other must contain the same
wildcards, in the same order.  The effect will be as with the Shell COPY
command.
>
EXIT
0
-
Leave Kermit-Perq immediately.  Reset devices etc. to the state
they had before entering Kermit.
NOTE:  An active remote server is not logged out.
>
QUIT
0
-
Leave Kermit-Perq immediately.  Keep the state of Kermit, so when
Kermit is re-entered all SET parameters etc. are in the same state.
NOTE:  An active remote server is not logged out.
>
PUSH
0
-
Not implemented.
>
TAKE
-1
TAKE filename
Read Kermit-Perq commands from the file specified.  Return at end of file.
Command files may be nested.  Default file extension is .CMD .
Equivalent to @<filename>.
>
CONNECT
0
-
Connect as a terminal to the remote machine.  (This Kermit will function as a
dumb terminal.)   CONNECT may be aborted, and you will be returned to the
main command level by pressing any tabswitch.
>
BYE
0
-
Leave Kermit-Perq as with EXIT, but Logout remote server first.
>
FINISH
0
-
Terminate server mode and return to normal command mode on remote Kermit.
>
REMOTE
0
-
Perform command at remote server Kermit.  Not implemented.
>
LOCAL
0
-
Perform command at Perq.  Not implemented.
>
SERVER
0

Enter server modus on this Kermit.  The Kermit will then receive all
its commands from the other Kermit, and be fully controlled by it.
(That means there is no exit from server modus until the other Kermit
relinquishes its control.)

Server modus is not yet implemented.

>
SET
17
Set parameter
SET
Alter parameters governing the way Kermit-Perq works.
Format: SET <parameter> <value>
>
BAUD
8
Set baudrate
BAUDRATE
Defines the transmission and reception speed of the RS232 line.
Default setting is 4800 baud, which should be used in the RUNIT
environment to be able to talk with most other computers.
>
110
0
-
Sets 110 bps transmission/reception speed.
>
150
0
-
Sets 150 bps transmission/reception speed.
>
300
0
-
Sets 300 bps transmission/reception speed.
>
600
0
-
Sets 600 bps transmission/reception speed.
>
1200
0
-
Sets 1200 bps transmission/reception speed.
>
2400
0
-
Sets 2400 bps transmission/reception speed.
>
4800
0
-
Sets 4800 bps transmission/reception speed.
>
9600
0
-
Sets 9600 bps transmission/reception speed.
>
PARITY
5
Set parity
PARITY
Defines the parity setting of the RS232 line.  Default setting
is EVEN, which should be used in the RUNIT environment to be
able to talk with most other computers.
>
NONE
0
-
Sets 8 bits receive/transmit, no parity generation or check.
Binary file transmission will be possible with all Kermit's.
>
EVEN
0
-
Sets 7 bits receive/transmit, even parity generation and check.
Note:  Binary file transmission will be impossible without
8-bit quote capability of the remote Kermit.
>
ODD
0
-
Sets 7 bits receive/transmit, odd parity generation and check.
Note:  Binary file transmission will be impossible without
8-bit quote capability of the remote Kermit.
>
MARK
0
-
Sets 7 bits receive/transmit,  with parity bit set to mark (1).
Note:  Binary file transmission will be impossible without
8-bit quote capability of the remote Kermit.
>
SPACE
0
-
Sets 7 bits receive/transmit,  with parity bit set to space (0).
Note:  Binary file transmission will be impossible without
8-bit quote capability of the remote Kermit.
>
STOP-BITS
4
Set stop bits
STOP-BITS
Set number of stop bits to use for the serial input/output (SIO).
>
SYNCHRONOUS
0
-
The SIO is set into synchronous mode.
(The command SET STOP-BITS SYNCHRONUS is somewhat misleading.)
>
1BIT
0
-
Use 1 stop bit, asyncronous mode for the SIO.
>
1.5BIT
0
-
Use 1.5 stop bits, asynchronous mode for the SIO.
>
2BIT
0
-
Use 2 stop bits, asyncronous mode for the SIO.
>
SEND
7
Set send
SEND
Alter parameters concerning sending of packets.
These parameters may also be changed by the initial connection
protocol during SEND or RECEIVE.  They may have to be adjusted
to get the first packet through to the other side.
>
PACKET-LENGTH
-1
SEND PACKET-LENGTH
Maximum length of packet to send.  To prevent buffer overrun, it should
not be set very much greater than the buffer size of the receiving
computer.  Long packets will improve performance, unless buffer overrun
occurs and garbles packets (requiring retransmission, wasting bandwidth).
>
QUOTE
-1
SEND QUOTE
Which character to use as a control quote when sending data.
Default and recommended is '#'.
>
START-OF-PACKET
-1
SEND START-OF-PACKET
Which character to use to mark the beginning of an outgoing packet.
This character defaults to ASCII SOH ( chr(1) ) and should not be
changed unless it is positively known that the other Kermit expects
something else.  It may be entered as ordinal number preceeded by '#',
or as a printable character (which is transformed by CTL) preceeded by '^',
i.e. control-B is entered as '#2' or '^B'.
>
TIMEOUT
-1
SEND TIMEOUT
The minimum number of seconds to wait for a reply before retrying,
when a packet has been sent.  Legal values are 1 to 94 (seconds).
>
END-OF-LINE
-1
SEND END-OF-LINE
Packet terminator character to use when sending.  Defaults to CR
(chr(13)).  May be entered as ordinal number preceeded by '#'
or one of the characters '@', 'A' to ']' or '^', preceeded by '^',
which will be transformed to the corresponding control character by CTL.
I.e. enter '^J' or '#10' to get LF (ctrl-J, chr(10)) as end-of-line.
>
PADDING
-1
SEND PADDING
Number of padchars to output before outputting the packet.
Defaults to zero.
>
PADCHAR
-1
SEND PADCHAR
Which padchar to use.  May be entered as ordinal number.
Defaults to ASCII NUL ( chr(0) ).
>
RECEIVE
4
Set receive
RECEIVE
Alter parameters concerning how a received packet is expected to look.
These parameters may also be adjusted by the initial connection protocol
during RECEIVE/SEND.
>
PACKET-LENGTH
-1
RECEIVE PACKET-LENGTH
Maximum length of packet to expect.  To prevent buffer overrun, it should
not be set very much greater than the ring buffer size of the Perq.
To be absolutely sure, use a value of 59, which will prevent any loss of
data if Kermit-Perq for some reason does not start taking the packet out
of the ring buffer before the other Kermit has finished sending.
(But long packets will improve performance of the protocol, as long as
overrun does not garble any packets.)
>
QUOTE
-1
RECEIVE QUOTE
Which character the other Kermit should use as a control quote when sending
data, and Kermit-Perq should interpret as control quote when receiving data.
Default and recommended is '#'.
>
START-OF-PACKET
-1
RECEIVE START-OF-PACKET
Which character to look for to detect the start of an incoming packet.
This character defaults to ASCII SOH ( chr(1) ) and should not be
changed unless it is positively known that the other Kermit sends
something else.  It may be entered as '#' and a ordinal number,
or as '^' and a printable character which is transformed by CTL, as for
end-of-line, i.e. control-B is entered as '#2' or '^B'.
>
TIMEOUT
-1
RECEIVE TIMEOUT
The minimum number of seconds the other Kermit should wait for a reply
before retrying when it has sent a packet.  Legal values are 1 to 94 (seconds).
>
FILE-HEADER
4
File header
FILE-HEADER
Set mode of transformation to be applied to the file names of transmitted
files.  Except for the NORD transformation, the transformations will only
be applied to the names of files sent from Kermit-Perq.

If specified, the transformation will apply to the second file name in the
SEND command or the first file name of the RECEIVE.
>
NORD
2
Nord
NORD
When ON, transform file names into a form suitable for the SINTRAN-III
file system of ND computer series.  When NORD transformation is ON,
none of the other transformations apply.  (That is:  Kermit acts as if
NO-TRUNCATE and CONVERT UPPER has been set, but when NORD is turned
off, these transforms will be returned to their previous settings.)

This transformation affects both SEND and RECEIVE files.
>
ON
0
-
SEND file names are transformed by changing all dots ('.') but the last one
into hyphens ('-').  Kermit-ND will change the last dot into a colon
and make the last part of the Perq filename the file type of the SINTRAN file
name.

The inverse transformation will be applied to the file names of RECEIVE'd
files.
>
OFF
0
-
NORD transformation is turned off.  The other transformations will be
put into effect.
>
NO-TRUNCATE
0
-
No truncation is applied to the Perq file name of a SEND file.  The
entire name (excluding path) is put into the file header packet.  This
option typically will require the receiving Kermit to be running on another
Perq.  The settings of the other options are not influenced.
>
TRUNCATE
-1
TRUNCATE
The filename is considered partitioned into parts delimited by dots ('.').
The argument of this command is a list of numbers, where each number gives
the maximum length of the matching part of a partitioned file name.

Every part is truncated to the length given by the mathcing number.
A part with no matching number will simply be omitted.

The matching rules are as follows

 1)     The first number always match the first (possibly only) part.

 2)     The last number match the last part whenever there is more than
        one part. (This is to avoid discarding the file extension.)

 3)     The remaining, unmatched items (if any) will be matched starting
        with the second number and the second part.

TRUNCATE with no argument will reactivate truncation with the same values
as before NO-TRUNCATE was issued.

To clarify:  Assume TRUNCATE 8,3
The name 'Firstpart.Secondpart.PAS' will be transformed into
'Firstpar.PAS'.  'Firstpart' will be transformed into 'Firstpar'.
If TRUNCATE 8,3,3 both the first name and 'Firstpart.Secondpart.Thirdpart.PAS'
would have become 'Firstpar.Sec.PAS'.

This transformation does not apply to RECEIVE'd file names.

The default setting is TRUNCATE 8,3 which is suitable for communication
with Kermit-32 under VAX/VMS, Kermit-80 under CP/M-80 and Kermit-86 under
DOS.
>
CONVERT
3
Convert
CONVERT
The file name may be converted into all upper or lower case letters, or left
as it is, according to the setting of this option.  The default setting is
UPPER-CASE, making Kermit-Perq transform all SEND file names into uppercase.
This transformation does not apply to RECEIVE file names.
>
LOWER
0
-
The file name will be translated into all lower case letters.
>
UPPER
0
-
The file name will be translated into all upper case letters.
>
OFF
0
-
The file name will not be translated.  (But possibly one of the other
transformations will apply.)
>
8-BIT-QUOTE
-1
8-BIT-QUOTE
Determine which character will be used as 8-bit quote.  Legal quote characters
are all printable characters except '@', 'A'-'Z', '[', '\', ']', '^' and any
character which is defined as another quote (usually '#' and '~').

Default and recommended 8-bit quote is '&'.  As a special case, 'Y' is allowed,
and means that 8-bit-quoting will be done with whatever character the other
Kermit wants to use.  The same effect is achieved with a blank entry.
>
USE-8-BIT-QUOTE
2
use 8-bit quote
USE-8-BIT-QUOTE
Specify whether 8-bit quoting is to be used or not.  Independent of setting
of 8-bit quote character.
>
AUTO
0
-
8-bit quoting will be done if PARITY NONE is not set (then it is not
necessary) and the other Kermit agrees.
>
OFF
0
-
8-bit quoting will not be done in any case.  Most useful in connection
with old Kermit's which do not support 8-bit quoting.  NB! Binary file
transfer will generally not be possible if PARITY NONE can't be set.
>
REPEAT-PREFIX
-1
REPEAT-PREFIX
Determine which character will be used as repeat prefix.  Legal prefix
characters are all printable characters except '@', 'A'-'Z', '[', '\', ']',
'^' and any character which is defined as another quote (usually '#' and '&').
>
USE-REPEAT-PREFIX
2
use repeat prefix
USE-REPEAT-PREFIX
Specify whether repeat prefixing is to be used or not.  Independent of setting
of repeat prefix.
>
AUTO
0
-
Repeat prefixing will be performed if the other Kermit agrees.
>
OFF
0
-
Repeat prefixing will not be done in any case.  Most useful in connection
wit old Kermit's which do not support repeat prefixing.
>
FILE-WARNING
2
File warning
FILE-WARNING
Determine what Kermit-Perq will do when receiving a file with the same name
as an existing file.
>
ON
0
-
If a file-name clash occurs, to avoid overwriting the existing file,
Kermit-Perq will modify the received file name by appending $'s until the
received file name is unique.
>
OFF
0
-
If a file-name clash occurs, Kermit-Perq will just go ahead and
write over the existing file.
>
RETRY
3
Set retry
RETRY
Sets the maximum number of retries before Kermit-Perq gives up an operation,
and aborts transfer.
>
INITIAL-CONNECTION
-1
RETRY INITIAL-CONNECTION
Sets the number of retries before Kermit-Perq gives up an attempt to
initiate a transfer.
The default value is 8.
>
PACKETS
-1
RETRY PACKETS
Sets the number of retries before Kermit-Perq gives up an attempt to
receive a good data- or acknowledge packet.
The default value is 5.
>
COMMANDS
-1
RETRY COMMANDS
Sets the number of retries before Kermit-Perq gives up an attempt to
send a command (such as LOGOUT or FINISH) to a remote server.
The default value is 3.
>
LOG-FILE
-1
LOG-FILE
Open file to log the terminal session to.  Logging is only active during
CONNECT modus, and is switched on or off by the SET LOG ON/OFF command.
If a log file is already open when the SET LOG-FILE command is issued,
this log-file is closed before the new one is opened.  If a blank file name
is entered, no new log-file is opened and logging is turned off.
Specifying the same file as already is active will rewind this file
and discard the previous log.
>
LOGGING
2
Set logging
LOGGING
Switch logging on or off.  The log-file must previously have been opened
by the SET LOG-FILE command.  Logging may be turned off and then on again,
and with no intervening SET LOG-FILE, the result will be that the new
log output will be appended to the same log-file.
>
ON
0
-
Turn logging on.  If no SET LOG-FILE has been issued since logging
was turned off, the log output will be appended to the active log-file.
SET LOG ON will be allowed when no log-file is open, but logging will
not commence until a SET LOG-FILE has been successfully executed.
>
OFF
0
-
Turn logging off.  Does NOT close log-file.  Turning logging back on again
will append to the end of the same log-file.
>
DEBUGGING
2
Debugging
DEBUGGING
Controls whether debug output is generated during file transfer.
>
ON
0
-
Debug output is generated:  Received and sent packets are dumped,
state transitions are monitored and more extensive error messages
are generated.  Interpretation of output will typically require a
quite intimate knowledge of the Kermit protocol.  Also: The
process of generating output will considerably slow down the transfer.
>
OFF
0
-
Debug output is not generated.
>
BREAK-TIME
-1
BREAK-TIME
Set number of milliseconds duration of a 'break'.
(Note: Break is not implemented, due to hardware limitations of the Perq .)
>
ESCAPE-CHARACTER
-1
ESCAPE-CHARACTER
Set the key which will be used to escape terminal mode and return to
Kermit-Perq after CONNECT.  It may be entered as a usual control character,
that is as a letter prefixed by '^', or as an ordinal number prefixed by '#'.

To utilize the special keys on the Perq keyboard, you may alternatively
enter the escape character by answering the 'ESCAPE-CHARACTER' prompt with
RETURN only.  You will then be asked to press the key which you want to be
used as escape key.  All combinations of CTRL and SHIFT is possible.  The only
keys which are not possible, are CTRL-SHIFT-C and HELP.

The default is CTRL-] as for most other Kermit's.
>
SHOW
18
-
SHOW
Show current setting of the SET parameters.
Refer to SET help menues for more explanations of the parameter values.
>
BAUD
0
-
Show speed of the serial communications line.
>
PARITY
0
-
Show parity generation/check on the serial communications line.
>
STOP
0
-
Show mode/number of stop bits to use on the serial communications line.
>
SEND
0
-
Show SEND parameters. (What this Kermit will use when sending packets
to the other one.)
>
RECEIVE
0
-
Show RECEIVE parameters.  (What this Kermit will tell the other one to
use when sending our way.)
>
FILE-HEADER
0
-
Show transformations to be applied to file name when transmitted.
>
8-BIT-QUOTE
0
-
Show the current 8-bit quote character.
>
USE-8-BIT-QUOTE
0
-
Show whether 8-bit quoting will be used.  (Will be used if necessary
when AUTO.)
>
REPEAT-PREFIX
0
-
Show the current repeat prefix character.
>
USE-REPEAT-PREFIX
0
-
Show whether repeat prefixing will be used.  (Will be used if necessary
when AUTO.)
>
FILE-WARNING
0
-
Show whether overwrite of existing file will be permitted.  (Will
not if ON.)
>
RETRY
0
-
Show retry limits before giving up transfer.
>
LOG-FILE
0
-
Show name of current opened log file.
>
LOGGING
0
-
Show whether terminal session is beeing logged to the log file.
>
DEBUGGING
0
-
Show whether debug output is generated.
>
BREAK-TIME
0
-
Show number of milliseconds duration of a line 'break'.
>
ESCAPE-CHARACTER
0
-
Show which key currently is in function as escape key.
>
ALL
0
-
Show status of all SET parameters.
>
STATUS
0
-
Show current status of Kermit.
>
STATISTICS
0
-
Show statistics from last transfer.  Not implemented.
>